package cn.iocoder.yudao.module.written.exam.service.userwrittenexamrecords;

import javax.validation.*;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.written.exam.controller.admin.member.vo.WrittenExamMemberPageReqVO;
import cn.iocoder.yudao.module.written.exam.controller.admin.member.vo.WrittenExamMemberRespVO;
import cn.iocoder.yudao.module.written.exam.controller.admin.userwrittenexamrecords.vo.UserWrittenExamRecordsPageReqVO;
import cn.iocoder.yudao.module.written.exam.controller.admin.userwrittenexamrecords.vo.UserWrittenExamRecordsRespVO;
import cn.iocoder.yudao.module.written.exam.controller.admin.userwrittenexamrecords.vo.UserWrittenExamRecordsUpdateReqVO;
import cn.iocoder.yudao.module.written.exam.controller.app.userwrittenexamrecords.vo.AppUserWrittenExamRecordsRespVO;
import cn.iocoder.yudao.module.written.exam.controller.admin.userwrittenexamrecords.vo.UserWrittenExamRecordsSaveReqVO;
import cn.iocoder.yudao.module.written.exam.dal.dataobject.userwrittenexamrecords.UserWrittenExamRecordsDO;

/**
 * 笔试记录 Service 接口
 *
 * @author 芋道源码
 */
public interface UserWrittenExamRecordsService {

    /**
     * 创建笔试记录
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createUserWrittenExamRecords(@Valid UserWrittenExamRecordsSaveReqVO createReqVO);

    /**
     * 更新笔试记录
     *
     * @param updateReqVO 更新信息
     */
    void updateUserWrittenExamRecords(UserWrittenExamRecordsUpdateReqVO updateReqVO);

    /**
     * 删除笔试记录
     *
     * @param id 编号
     */
    void deleteUserWrittenExamRecords(Long id);

    /**
     * 获得笔试记录
     *
     * @param id 编号
     * @return 笔试记录
     */
    UserWrittenExamRecordsDO getUserWrittenExamRecords(Long id);

    /**
     * 获得笔试记录
     *
     * @param id 编号
     * @return 笔试记录
     */
    AppUserWrittenExamRecordsRespVO getUserWrittenExamRecordsForApp(Long id);

    /**
     * 通过会话id获得笔试记录
     *
     * @param conversationId 会话id
     * @return 笔试记录
     */
    UserWrittenExamRecordsDO getUserWrittenExamRecordsByConversationId(String conversationId);

    /**
     * 获得笔试记录分页
     *
     * @param pageReqVO 分页查询
     * @return 笔试记录分页
     */
    PageResult<UserWrittenExamRecordsRespVO> getUserWrittenExamRecordsPage(UserWrittenExamRecordsPageReqVO pageReqVO);

    /**
     * 获得笔试记录分页
     *
     * @param pageReqVO 分页查询
     * @return 笔试记录分页
     */
    PageResult<AppUserWrittenExamRecordsRespVO> getUserWrittenExamRecordsPageForApp(UserWrittenExamRecordsPageReqVO pageReqVO);

    /**
     * 获得笔试会员分页
     *
     * @param pageReqVO 分页查询
     * @return 笔试会员分页
     */
    PageResult<WrittenExamMemberRespVO> getWrittenExamMemberPage(WrittenExamMemberPageReqVO pageReqVO);

}